home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / xwindows / games / xtrek_bi.tz / xtrek_bi / xtrek / README < prev    next >
Text File  |  1991-12-17  |  5KB  |  148 lines
  1. Since  the regular  documentation  is rather detailed,   this  will be
  2. almost equally brief.
  3.  
  4. What you need to do :
  5.  
  6.     edit the Imakefile to reflect your system's setup with regard to where
  7.     you will have the xtrek lib directory living, and where the
  8.     font should go.
  9.  
  10.     remake the makefile (xmkmf) or "make Makefile"
  11.  
  12.     modify config.h to reflect changes to the Imakefile
  13.  
  14.     make install install.man
  15.  
  16.     GO FOR IT!
  17.  
  18.     Detailed documentation can be found in xtrekguide.{tex,ps}, but the
  19. main things you need to do :
  20.  
  21.     xtrekd
  22.  
  23.     Status messages will be dumped out as the daemon loads the default
  24. configuration. When it says 'Daemon ready',
  25.  
  26.     xtrek <machine-xtrekd-is-on>
  27.  
  28. in another window (or on another machine) to send a window request to the 
  29. daemon. You will then recieve the xtrek window - choose a race, and have 
  30. fun. Invite other players in or hit 'H' to turn on the robot horde (one 
  31. robot maintained for all races).
  32.  
  33.     NOTES: 
  34.  
  35.  
  36.         * xtrekd will exit if no players are active. Robots are 
  37.             counted as active players.
  38.  
  39.         * On some machines or some setups, we're not sure which,
  40.             you will need to explicitly set all defaults.
  41.             Ala :
  42.  
  43.              xtrek.boldfont:         6x10b
  44.              xtrek.font:             6x10
  45.              xtrek.reverseVideo:     off
  46.              xtrek.showShields:      on
  47.              xtrek.showStats:        on
  48.              xtrek.stats.geometry:   +0+655
  49.              xtrek.GAlertPattern:    0xf
  50.              xtrek.YAlertPattern:    0xa 0x5
  51.              xtrek.RAlertPattern:    0x0f 0x0f 0x0f 0x0f 0xf0 0xf0 0xf0 0xf0
  52.              xtrek.ralert:           red
  53.              xtrek.yalert:           yellow
  54.              xtrek.galert:           green
  55.              xtrek.border:           blue
  56.              xtrek.background:       black
  57.              xtrek.text:             white
  58.              xtrek.warning:          red
  59.              xtrek.unknown:          light grey
  60.              xtrek.me:               white
  61.  
  62.             Try to get by without them first, though.
  63.  
  64.         * the xtrek "client" has a concept of where the font "xtrek"
  65.             will be installed so that it can attempt to insure
  66.             that it is on the server fontpath when the game
  67.             starts. If you don't see the font:
  68.  
  69.             * make sure it installed where FONTDIR points; insure
  70.             that the Imakefile and config.h agree where it is.
  71.  
  72.             * see below if confusion still reigns
  73.  
  74.         In particular, if you get X errors involving X_Set_Fontpath
  75.         this is a hint that FONTDIR is pointing somewhere bogus.
  76.  
  77.         * to generate fonts: the Imakefile provided will be able to
  78.             generate and install fonts on MIT X11R4 and R5 systems.
  79.             It is impossible to automatically intuit what system
  80.             you may have, however, so you may need to install the
  81.             font by hand. In that case:
  82.  
  83.             * OpenWindows/OpenLook:
  84.  
  85.                 convertfont -b xtrek.bdf
  86.                 copy resulting xtrek.fb file to FONTDIR
  87.                 execute "bldfamily" in FONTDIR
  88.  
  89.             * DECWindows
  90.  
  91.                 dxfc < xtrek.bdf > xtrek.pcf
  92.                 cp xtrek.pcf FONTDIR
  93.                 execute "dxmkfontdir" in FONTDIR
  94.             
  95.                 DECWindows fonts tend to work in R5 systems, the 
  96.                 reverse is not true.
  97.  
  98.             * Something else? I have no idea what'll work. It is
  99.                 probably worth trying the "standard" method:
  100.  
  101.                 bdftosnf < xtrek.bdf > xtrek.snf
  102.                 cp xtrek.snf FONTDIR
  103.                 execute "mkfontdir" in FONTDIR
  104.  
  105.                 providing, of course, that whatever box you have
  106.                 comes with a bdftosnf/mkfontdir combo (R4 standard).
  107.  
  108.             * Still stuck? Break out the manual sets ... in particular,
  109.                 X terminals (which I have run Xtrek on) may require
  110.                 a different endian-ness flavor of font than your
  111.                 machine produces. Most vendors ship a bdftosnf which
  112.                 Does the Right Thing.
  113.  
  114.             * Still? Argh. Call a TechDroid. BTW, it is faster to do an
  115.  
  116.                 xset fp+ FONTDIR
  117.                 xfd -fn xtrek
  118.  
  119.                 to try to bring the font up than to start Xtrek.
  120.  
  121.         * BSD and SYSV systems often differ in how they handle signals.
  122.         Therefore, there is code in input.c'setRedrawFlag to reset
  123.         the update signal handler on USG and SYSV systems. I have
  124.         no idea if this is the maximal set of machines that have
  125.         the "problem" of non-sticky signal handlers. You may have
  126.         to force the code in there to compile on your system. If you
  127.         get "Alarm clock" bombs in the server (or similar), this is
  128.         your problem.
  129.  
  130.  
  131.     I am reasonably confident that this release represents a stable
  132. xtrek. Over the last two years I have been answering mail about this game
  133. and I think I have addressed all the problems I have seen in this release.
  134. In particular, the only remaining floating point bug should be fixed in this
  135. version.
  136.  
  137.     Also, this release hopefully represents my/our last involvement with
  138. this game. The last three years have been fun at times and a royal pain
  139. at others, but it is now time for someone else who is interested in
  140. extending the game to pick it up. If you are interested, please contact
  141. me.
  142.  
  143.         thanks,
  144.  
  145.             dan lovinger
  146.             dl2n+@andrew.cmu.edu
  147.             (for everyone here)
  148.